<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>gchartjava Overview</title>
</head>
<body>

<a href="http://gchartjava.googlecode.com">gchartjava</a>
is a Java chart library that enables developers to
<b>programmatically</b>
generate all the charts available in the
<a href="http://code.google.com/apis/chart/">Google Chart API</a>
(except QR codes). gchartjava can be incorporated into any Java Internet
or web application environment (e.g. JSPs / Servlets, Spring MVC, GWT, etc.)

<h3>Installation</h3>

<p>Developers only need to include two jars in their class path to
use gchartjava; the gchartjava.jar and the excellent
google-collections.jar. Both are available in the <a
	href="http://code.google.com/p/gchartjava/downloads/list">gchartjava.zip</a>
file. The application must also be connected to the Internet because the
charts are ultimately rendered by the Google Chart API server.</p>

<h3>Usage</h3>

<p>Developers who are using gchartjava for the first time should
start off by examining the {@link com.googlecode.gchartjava.Data} and
{@link com.googlecode.gchartjava.DataUtil} classes. Next, they can build
charts via the {@link com.googlecode.gchartjava.GCharts} static factory
class.</p>

<p>All data provided to gchartjava is expressed as numbers between 0
and 100. If your data does not fall in that range, you will have to
scale it so it does fall in that range. The {@link
com.googlecode.gchartjava.DataUtil} class can help scale data. Also note
that {@link
com.googlecode.gchartjava.AbstractAxisChart#setGrid(double,double,int,int)
grids}, {@link com.googlecode.gchartjava.AxisLabelsFactory axis labels
positions}, {@link com.googlecode.gchartjava.Markers markers} are all
expressed in the 0 to 100 range so that chart elements defined by the
developer snap together consistently and nicely.</p>


<p>Another interesting feature of gchartjava: {@link
com.googlecode.gchartjava.Plot}s can be incorporated into more than one
chart type. In particular, they can be incorporated into
<ul>
	<li>{@link com.googlecode.gchartjava.LineChart}s</li>
	<li>{@link com.googlecode.gchartjava.XYLineChart}s</li>
	<li>{@link com.googlecode.gchartjava.BarChart}s</li>
    <li>{@link com.googlecode.gchartjava.ScatterPlot}s</li>
    <li>{@link com.googlecode.gchartjava.RadarChart}s</li>
</ul>
{@link com.googlecode.gchartjava.Plot}s are created via the {@link com.googlecode.gchartjava.Plots} static factory class.
{@link com.googlecode.gchartjava.GChart}s are created via the {@link com.googlecode.gchartjava.GCharts} static factory class.
</p>

<p>Chart URLs {@link com.googlecode.gchartjava.GChart#toURLString()
generated} by gchartjava can then be incorporated into a web or Internet
application. In a JSP / Servlet environment, generate the URL in the
servlet and insert that URL in the JSP for display of the chart.</p>

<br>
Code examples can be found <a href="http://gchartjava.googlecode.com">here</a>.
<br>
<br>

For additional information, see:
<ul>
	<li><a href="http://gchartjava.googlecode.com">gchartjava</a></li>
	<li><a href="http://code.google.com/apis/chart/">Google Chart API</a></li>
	<li><a href="http://groups.google.com/group/google-chart-api">Google Chart API Group</a></li>
    <li><a href="http://google-collections.googlecode.com">google-collections</a></li>
</ul>
@author Julien Chastang (julien.c.chastang at gmail dot com)
</body>
</html>